Summary

pscale branch list-tablets returned every tablet on a branch with no way to filter. On large, multi-keyspace branches, finding the specific tablet alias you need (e.g. for a throttlerconfig change) meant parsing the full output by hand.

Changes

Four optional flags on branch list-tablets:

• --keyspace — only list tablets in this keyspace.
• --shard — only list tablets in this shard (requires --keyspace, matching vitess semantics).
• --tablet-type — only list tablets of this type (e.g. primary, replica, rdonly).
• --tablet-alias — only list the tablet(s) with these aliases (comma-separated / repeatable). When set, the other filters are ignored.

With no flags the behavior is unchanged. Validation of the filter combinations (e.g. shard without keyspace, unknown tablet type) is handled server-side and surfaced via the normal error path. Bumps planetscale-go to v0.168.0 for the new ListBranchTabletsRequest filter fields.

Rendered help:

Usage:
  pscale branch vtctld list-tablets <database> <branch> [flags]

Flags:
  -h, --help                   help for list-tablets
      --keyspace string        Only list tablets in this keyspace
      --shard string           Only list tablets in this shard (requires --keyspace)
      --tablet-alias strings   Only list the tablet(s) with these aliases, e.g. zone1-0000000100 (comma-separated; overrides the other filters)
      --tablet-type string     Only list tablets of this type (e.g. primary, replica, rdonly)

Testing

Added list_tablets_test.go: one case asserting an unfiltered call sends empty filters, and one asserting all four flags (including comma-separated --tablet-alias) are forwarded to the SDK request. go build, go vet, gofmt, and the vtctld package tests pass locally; verified the --help output renders the flags as shown above.